Skip to content

docs: document DENO_CACHE_MAX_SIZE env var (2.8)#3079

Open
lunadogbot wants to merge 1 commit into
denoland:2.8from
lunadogbot:docs/2.8-cache-max-size
Open

docs: document DENO_CACHE_MAX_SIZE env var (2.8)#3079
lunadogbot wants to merge 1 commit into
denoland:2.8from
lunadogbot:docs/2.8-cache-max-size

Conversation

@lunadogbot
Copy link
Copy Markdown
Contributor

Summary

Adds DENO_CACHE_MAX_SIZE to the Special environment variables table on runtime/reference/env_variables.md, documenting the new automatic cache-trimming knob in Deno 2.8 (denoland/deno#32932).

  • Trim runs after cache-writing subcommands (run, cache, check, test, bench, compile, install, serve, eval).
  • Oldest files (by mtime) are removed first.
  • Accepts human-readable size suffixes: B, K/KB, M/MB, G/GB, T/TB, case-insensitive, fractional values like 1.5G.

Test plan

  • deno task serve — env_variables table renders, the new row aligns.

Adds DENO_CACHE_MAX_SIZE to the special-environment-variables table.
Notes the LRU-by-mtime trim behavior, the supported size suffixes
(B/K/KB/M/MB/G/GB/T/TB, case-insensitive, fractional), and which
subcommands trigger the trim.

Refs denoland/deno#32932
@crowlKats crowlKats changed the base branch from main to 2.8 May 5, 2026 11:44
Copy link
Copy Markdown

@fibibot fibibot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Single-row addition to the env-variables table. Description matches the upstream PR linked in the body — mtime-based trimming after cache-writing subcommands, suffix grammar (B/K/KB/M/MB/G/GB/T/TB, case-insensitive, fractional) reads correctly.

No check-runs reported on this head SHA — looks like CI doesn't auto-fire on PRs targeting the 2.8 release branch. Holding approval until CI is green.

  • nit: last_modified: 2025-12-19 in the frontmatter wasn't bumped — repo convention bumps it for content additions.
  • nit: #3081 adds NODE_EXTRA_CA_CERTS to the same table a few rows up; whichever lands second will need a trivial rebase.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants